@@ -92,6 +92,47 @@
 
 The corresponding save methods (`save_as_text()`, `save_as_markdown()`, `save_as_html()`, `save_as_vtt()`) support the same parameters as their export counterparts, with one difference: `save_as_vtt()` defaults `omit_voice_end` to True (while `export_to_vtt()` defaults it to False) for more concise output files.
 
+### Doclang (Experimental) Serializer
+
+The experimental Doclang serializer (`docling_core/experimental/doclang.py`) also supports content layer filtering and annotation via `DoclangParams`.
+
+**Content layer filtering:** The `layers` field controls which content layers are serialized. It accepts a `set[ContentLayer]` and defaults to all content layers. To serialize only the body layer, for example:
+
+```python
+from docling_core.experimental.doclang import DoclangParams
+from docling_core.types.doc import ContentLayer
+
+params = DoclangParams(layers={ContentLayer.BODY})
+```
+
+**Layer annotation:** The `layer_mode` field of type `LayerMode` controls whether a `<layer class="..."/>` self-closing XML token is emitted for each item:
+- `LayerMode.MINIMAL` (default): emits `<layer class="..."/>` only when the item's content layer differs from `ContentLayer.BODY`.
+- `LayerMode.ALWAYS`: emits `<layer class="..."/>` for every item, regardless of its layer.
+
+```python
+from docling_core.experimental.doclang import DoclangParams, LayerMode
+from docling_core.types.doc import ContentLayer
+
+params = DoclangParams(
+    layers={ContentLayer.BODY, ContentLayer.FURNITURE},
+    layer_mode=LayerMode.MINIMAL,
+)
+```
+
+In the serialized XML output, content layer information appears as an embedded self-closing token, for example:
+
+```xml
+<page_header>
+  <layer class="furniture"/>
+  Page Header
+</page_header>
+<text>
+  Main body content
+</text>
+```
+
+With `LayerMode.ALWAYS`, `<layer class="body"/>` would also appear inside the `<text>` block above.
+
 ## Iterating Over Items Including Furniture
 
 For advanced use cases, such as iterating over document items including headers and footers, use the `iterate_items` method with the appropriate content layers: